example - #533

#!/bin/bash
set -euo pipefail

if rg -n '\\[{}]' \
  v2/rscg_examples_site/docs/RSCG-Examples/IncrementalSourceGenerator.BuilderPattern.md
then
  echo "Escaped braces remain in the documentation."
  exit 1
fi

#!/bin/bash
set -euo pipefail

rg -nP '^\s*public\s+(partial\s+)?class\s+Person\b' \
  v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern/src/Builder/Person.cs

rg -n 'public partial class Person' \
  v2/rscg_examples_site/docs/RSCG-Examples/IncrementalSourceGenerator.BuilderPattern.md

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- source tree ---'
git ls-files 'v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern/*' \
  'v2/rscg_examples_site/docs/RSCG-Examples/IncrementalSourceGenerator.BuilderPattern.md'

printf '%s\n' '--- Person.cs ---'
cat -n v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern/src/Builder/Person.cs

printf '%s\n' '--- project configuration ---'
fd -i -t f 'csproj|props|targets' v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern \
  --exec sh -c 'echo --- "$1"; cat -n "$1"' sh {}

printf '%s\n' '--- documented generated declaration ---'
sed -n '165,200p' v2/rscg_examples_site/docs/RSCG-Examples/IncrementalSourceGenerator.BuilderPattern.md

printf '%s\n' '--- Person declarations and generator references ---'
rg -n -C 3 'class Person\b|PersonBuilder|partial' \
  v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern \
  v2/rscg_examples_site/docs/RSCG-Examples/IncrementalSourceGenerator.BuilderPattern.md

#!/bin/bash
set -euo pipefail

python3 - <<'PY'
from pathlib import Path
import re

source = Path("v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern/src/Builder/Person.cs").read_text(encoding="utf-8-sig")
docs = Path("v2/rscg_examples_site/docs/RSCG-Examples/IncrementalSourceGenerator.BuilderPattern.md").read_text(encoding="utf-8")

source_decl = re.findall(r"^\s*public\s+(partial\s+)?class\s+Person\b", source, re.MULTILINE)
generated_decl = re.findall(r"^\s*public\s+(partial\s+)?class\s+Person\b", docs, re.MULTILINE)

print("source Person declarations:", source_decl)
print("documented Person declarations:", generated_decl)
print("source declaration is partial:", source_decl == [""])
print("generated declaration is partial:", any(value == "partial " for value in generated_decl))

# Identify the two documentation blocks so the source example and generated output
# are not conflated.
for marker in ("public class Person", "public partial class Person"):
    print(f"documentation contains {marker!r}:", marker in docs)
PY

#!/bin/bash
set -euo pipefail

rg -n '<Nullable>enable|TreatWarningsAsErrors|WarningsAsErrors' \
  -g '*.csproj' -g '*.props' -g '*.targets'

rg -n 'public string (FirstName|LastName)' \
  v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern/src/Builder/Person.cs

set -u

printf '%s\n' '--- candidate files ---'
git ls-files 'v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern/*' \
  | sed -n '1,120p'

printf '%s\n' '--- project and source references ---'
rg -n -C 4 'Nullable|TreatWarningsAsErrors|WarningsAsErrors|FirstName|LastName|partial class Person|class Person|WithFirstName|WithLastName|Build\(' \
  v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern \
  -g '*.cs' -g '*.csproj' -g '*.props' -g '*.targets' -g '*.md' || true

printf '%s\n' '--- relevant file contents ---'
for f in \
  v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern/src/Builder/Person.cs \
  v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern/src/Builder/Builder.csproj
do
  if [ -f "$f" ]; then
    echo "### $f"
    cat -n "$f"
  fi
done

set -u

printf '%s\n' '--- generator package usage and builder semantics in the repository ---'
rg -n -C 4 'IncrementalSourceGenerator\.BuilderPattern|Builder\(typeof|WithFirstName|WithLastName|PersonBuilder|Build\(\)' . \
  -g '*.cs' -g '*.csproj' -g '*.md' -g '*.json' -g '*.txt' \
  | sed -n '1,240p'

printf '%s\n' '--- generated-file references and nullable overrides ---'
rg -n -C 3 'EmitCompilerGeneratedFiles|CompilerGeneratedFilesOutputPath|`#nullable`|NoWarn|WarningsAsErrors|TreatWarningsAsErrors|Nullable' \
  v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern . \
  -g '*.cs' -g '*.csproj' -g '*.props' -g '*.targets' \
  | sed -n '1,200p'

set -u

printf '%s\n' '--- checked-in example documentation ---'
for f in \
  v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern/description.json \
  v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern/src/Builder/Program.cs
do
  if [ -f "$f" ]; then
    echo "### $f"
    cat -n "$f"
  fi
done

printf '%s\n' '--- generated API text in checked-in documentation ---'
rg -n -C 3 'generatedCode|With[A-Z]|Build|new Person|FirstName|LastName' \
  v2/rscg_examples/IncrementalSourceGenerator.BuilderPattern \
  -g '*.json' -g '*.md' -g '*.txt' || true

set -u

repo='MartinBarrettNielsen11/Incremental-source-generator-builder-pattern'

printf '%s\n' '--- upstream repository metadata ---'
curl -L --silent --show-error --fail \
  "https://api.github.com/repos/$repo" \
  | jq '{full_name,private,archived,default_branch}' || true

printf '%s\n' '--- upstream source tree ---'
curl -L --silent --show-error --fail \
  "https://api.github.com/repos/$repo/git/trees/main?recursive=1" \
  | jq -r '.tree[]?.path' \
  | rg -i 'builder|generator|readme|cs$' \
  | sed -n '1,160p' || true

printf '%s\n' '--- package metadata ---'
curl -L --silent --show-error --fail \
  'https://api.nuget.org/v3-flatcontainer/incrementalsourcegenerator.builderpattern/1.0.2/incrementalsourcegenerator.builderpattern.nuspec' \
  | sed -n '1,160p' || true

set -u

base='https://raw.githubusercontent.com/MartinBarrettNielsen11/Incremental-source-generator-builder-pattern/main'

printf '%s\n' '--- generator output implementation ---'
for path in \
  Generator/Helpers/BuilderSourceWriter.cs \
  Generator/Helpers/Properties.cs \
  tests/GeneratorTests/Snapshots/FunctionalTests.EntityIsConstructed_When_InvokingBuildMethod.verified.txt \
  tests/GeneratorTests/Snapshots/FunctionalTests.IntendedMethodsAreGenerated.verified.txt \
  Generator.Demo/Entites.cs \
  Generator.Demo/Builders.cs
do
  echo "### $path"
  curl -L --silent --show-error --fail "$base/$path" \
    | nl -ba \
    | sed -n '1,260p' || true
done

set -u

base='https://raw.githubusercontent.com/MartinBarrettNielsen11/Incremental-source-generator-builder-pattern/main'

for path in \
  Generator/Helpers/BuilderSourceWriter.cs \
  Generator/Helpers/Properties.cs \
  tests/GeneratorTests/Snapshots/FunctionalTests.EntityIsConstructed_When_InvokingBuildMethod.verified.txt \
  tests/GeneratorTests/Snapshots/FunctionalTests.IntendedMethodsAreGenerated.verified.txt \
  Generator.Demo/Entites.cs \
  Generator.Demo/Builders.cs
do
  echo "### $path"
  curl -L --silent --show-error --fail "$base/$path" \
    | sed -n '1,320p' || true
done